home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-9.10-netbook-remix-PL.iso / casper / filesystem.squashfs / usr / lib / python2.6 / dist-packages / snack.pyc (.txt) < prev    next >
Encoding:
Python Compiled Bytecode  |  2009-10-28  |  39.1 KB  |  1,082 lines
  1. # Source Generated with Decompyle++
  2. # File: in.pyc (Python 2.6)
  3.  
  4. '''
  5. This module provides the NEWT Windowing toolkit API for Python
  6. This is a lightweight text-mode windowing library, based on slang.
  7.  
  8. Classes:
  9.  
  10.  - Widget  
  11.  - Button  
  12.  - CompactButton
  13.  - Checkbox
  14.  - SingleRadioButton
  15.  - Listbox
  16.  - Textbox
  17.  - TextboxReflowed
  18.  - Label
  19.  - Scale
  20.  - Entry
  21.  - Form
  22.  - Grid
  23.  - SnackScreen
  24.  - RadioGroup
  25.  - RadioBar
  26.  - ButtonBar
  27.  - GridFormHelp
  28.  - GridForm
  29.  - CheckboxTree
  30.  - Clistbox
  31.  
  32. Functions:
  33.  
  34.  - ListboxChoiceWindow
  35.  - ButtonChoiceWindow
  36.  - EntryWindow
  37. '''
  38. import _snack
  39. import types
  40. import string
  41. from _snack import FLAG_DISABLED, FLAGS_SET, FLAGS_RESET, FLAGS_TOGGLE, FD_READ, FD_WRITE, FD_EXCEPT
  42. LEFT = (-1, 0)
  43. DOWN = (-1, -1)
  44. CENTER = (0, 0)
  45. UP = (1, 1)
  46. RIGHT = (1, 0)
  47. snackArgs = {
  48.     'append': -1 }
  49.  
  50. class Widget:
  51.     '''Base class for NEWT toolkit - Do not use directly
  52.  
  53.     methods:
  54.  
  55.      - Widget(self)
  56.      - setCallback(self, obj, data = None) : 
  57.           The callback for when object activated.
  58.           data is passed to obj.
  59.     '''
  60.     
  61.     def setCallback(self, obj, data = None):
  62.         if data:
  63.             self.w.setCallback(obj, data)
  64.         else:
  65.             self.w.setCallback(obj)
  66.  
  67.     
  68.     def __init__(self):
  69.         raise NotImplementedError
  70.  
  71.  
  72.  
  73. class Button(Widget):
  74.     '''Basic button class, takes button text as parameter
  75.  
  76.     method:
  77.  
  78.      - Button(self, text): returns a button
  79.     '''
  80.     
  81.     def __init__(self, text):
  82.         self.w = _snack.button(text)
  83.  
  84.  
  85.  
  86. class CompactButton(Widget):
  87.     '''Compact Button class (less frilly button decoration).
  88.  
  89.     methods:
  90.  
  91.      - CompactButton(self,text) : create button, with text.
  92.     '''
  93.     
  94.     def __init__(self, text):
  95.         self.w = _snack.compactbutton(text)
  96.  
  97.  
  98.  
  99. class Checkbox(Widget):
  100.     '''A checkbox.
  101.  
  102.     methods:
  103.     
  104.       - Checkbox(self, text, isOn = 0) : text, and boolean as to default value
  105.       - setValue(self)                 : set value
  106.       - value(self, value)             : return checkbox value
  107.       - selected(self)                 : returns boolean
  108.       - setFlags(self, flag, sense)    : set flags
  109.  
  110.       flags:  FLAG_DISABLED, FLAGS_SET, FLAGS_RESET
  111.     '''
  112.     
  113.     def value(self):
  114.         return self.w.checkboxValue
  115.  
  116.     
  117.     def selected(self):
  118.         return self.w.checkboxValue != 0
  119.  
  120.     
  121.     def setFlags(self, flag, sense):
  122.         return self.w.checkboxSetFlags(flag, sense)
  123.  
  124.     
  125.     def setValue(self, value):
  126.         return self.w.checkboxSetValue(value)
  127.  
  128.     
  129.     def __init__(self, text, isOn = 0):
  130.         self.w = _snack.checkbox(text, isOn)
  131.  
  132.  
  133.  
  134. class SingleRadioButton(Widget):
  135.     '''Single Radio Button.
  136.  
  137.     methods:
  138.     
  139.      -  SingleRadioButton(text, group, isOn = 0)  : create button
  140.      -  selected(self)                            : returns bool, whether or not is selected.
  141.     '''
  142.     
  143.     def selected(self):
  144.         return self.w.key == self.w.radioValue
  145.  
  146.     
  147.     def __init__(self, text, group, isOn = 0):
  148.         if group:
  149.             self.w = _snack.radiobutton(text, group.w, isOn)
  150.         else:
  151.             self.w = _snack.radiobutton(text, None, isOn)
  152.  
  153.  
  154.  
  155. class Listbox(Widget):
  156.     """Listbox class.
  157.  
  158.     methods:
  159.  
  160.      - Listbox(self, height, scroll = 0, returnExit = 0, width = 0, showCursor = 0, multiple = 0, border = 0)
  161.      - insert(self, text, item, before) : insert element; before = key to item to insert before, or None.
  162.      - delete(self, item)               : delete item from list.
  163.      - replace(self, text,item)         : Replace a given item's text
  164.      - current(self)                    : returns currently selected item
  165.      - getSelection(self)               : returns a list of selected items
  166.      - setCurrent(self,i tem)           : select current.
  167.      - clear(self)                      : clear listbox
  168.     """
  169.     
  170.     def append(self, text, item):
  171.         key = self.w.listboxAddItem(text)
  172.         self.key2item[key] = item
  173.         self.item2key[item] = key
  174.  
  175.     
  176.     def insert(self, text, item, before):
  177.         if not before:
  178.             key = self.w.listboxInsertItem(text, 0)
  179.         else:
  180.             key = self.w.listboxInsertItem(text, self.item2key[before])
  181.         self.key2item[key] = item
  182.         self.item2key[item] = key
  183.  
  184.     
  185.     def delete(self, item):
  186.         self.w.listboxDeleteItem(self.item2key[item])
  187.         del self.key2item[self.item2key[item]]
  188.         del self.item2key[item]
  189.  
  190.     
  191.     def replace(self, text, item):
  192.         key = self.w.listboxInsertItem(text, self.item2key[item])
  193.         self.w.listboxDeleteItem(self.item2key[item])
  194.         del self.key2item[self.item2key[item]]
  195.         self.item2key[item] = key
  196.         self.key2item[key] = item
  197.  
  198.     
  199.     def current(self):
  200.         return self.key2item[self.w.listboxGetCurrent()]
  201.  
  202.     
  203.     def getSelection(self):
  204.         selection = []
  205.         list = self.w.listboxGetSelection()
  206.         for key in list:
  207.             selection.append(self.key2item[key])
  208.         
  209.         return selection
  210.  
  211.     
  212.     def setCurrent(self, item):
  213.         self.w.listboxSetCurrent(self.item2key[item])
  214.  
  215.     
  216.     def clear(self):
  217.         self.key2item = { }
  218.         self.item2key = { }
  219.         self.w.listboxClear()
  220.  
  221.     
  222.     def __init__(self, height, scroll = 0, returnExit = 0, width = 0, showCursor = 0, multiple = 0, border = 0):
  223.         self.w = _snack.listbox(height, scroll, returnExit, showCursor, multiple, border)
  224.         self.key2item = { }
  225.         self.item2key = { }
  226.         if width:
  227.             self.w.listboxSetWidth(width)
  228.         
  229.  
  230.  
  231.  
  232. class Textbox(Widget):
  233.     '''Textbox, container for text.
  234.  
  235.     methods:
  236.  
  237.      - Textbox(self, width, height, scroll = 0, wrap = 0): scroll, wrap are flags
  238.                                    include scroll bars, or text wrap.
  239.      - setText(text) : set text.
  240.      - setHeight(height): set height.
  241.     '''
  242.     
  243.     def setText(self, text):
  244.         self.w.textboxText(text)
  245.  
  246.     
  247.     def setHeight(self, height):
  248.         self.w.textboxHeight(height)
  249.  
  250.     
  251.     def __init__(self, width, height, text, scroll = 0, wrap = 0):
  252.         self.w = _snack.textbox(width, height, text, scroll, wrap)
  253.  
  254.  
  255.  
  256. class TextboxReflowed(Textbox):
  257.     
  258.     def __init__(self, width, text, flexDown = 5, flexUp = 10, maxHeight = -1):
  259.         (newtext, width, height) = reflow(text, width, flexDown, flexUp)
  260.         if maxHeight != -1 and height > maxHeight:
  261.             Textbox.__init__(self, width, maxHeight, newtext, 1)
  262.         else:
  263.             Textbox.__init__(self, width, height, newtext, 0)
  264.  
  265.  
  266.  
  267. class Label(Widget):
  268.     '''A Label (simple text).
  269.  
  270.     methods:
  271.  
  272.      - Label(self,text)   : create label
  273.      - setText(self,text) : change text.
  274.     '''
  275.     
  276.     def setText(self, text):
  277.         self.w.labelText(text)
  278.  
  279.     
  280.     def __init__(self, text):
  281.         self.w = _snack.label(text)
  282.  
  283.  
  284.  
  285. class Scale(Widget):
  286.     '''A Scale (progress bar).
  287.  
  288.     methods:
  289.  
  290.      - Scale(self,width, total) : create scale; width: size on screen, fullamount: integer.
  291.      - set(self,amount)         : set amount to integer.
  292.     '''
  293.     
  294.     def set(self, amount):
  295.         self.w.scaleSet(amount)
  296.  
  297.     
  298.     def __init__(self, width, total):
  299.         self.w = _snack.scale(width, total)
  300.  
  301.  
  302.  
  303. class Entry(Widget):
  304.     '''Entry widget.
  305.  
  306.     methods:
  307.  
  308.      - Entry(self, width, text = "", hidden = 0, password = 0, scroll = 1, returnExit = 0)
  309.           constructor. hidden doesn\'t show text, password stars it out,
  310.           scroll includes scroll bars;
  311.           if returnExit is set, return from Form when exiting this element, else
  312.            proceed to next entry widget.
  313.      - value(self): return value.
  314.      - set(text, cursorAtEnd = 1) : set the text
  315.      - setFlags (flag, sense) : flags can be FLAG_DISABLED, FLAGS_SET, FLAGS_RESET, FLAGS_TOGGLE
  316.     '''
  317.     
  318.     def value(self):
  319.         return self.w.entryValue
  320.  
  321.     
  322.     def set(self, text, cursorAtEnd = 1):
  323.         return self.w.entrySetValue(text, cursorAtEnd)
  324.  
  325.     
  326.     def setFlags(self, flag, sense):
  327.         return self.w.entrySetFlags(flag, sense)
  328.  
  329.     
  330.     def __init__(self, width, text = '', hidden = 0, password = 0, scroll = 1, returnExit = 0):
  331.         self.w = _snack.entry(width, text, hidden, password, scroll, returnExit)
  332.  
  333.  
  334. hotkeys = {
  335.     'F1': _snack.KEY_F1,
  336.     'F2': _snack.KEY_F2,
  337.     'F3': _snack.KEY_F3,
  338.     'F4': _snack.KEY_F4,
  339.     'F5': _snack.KEY_F5,
  340.     'F6': _snack.KEY_F6,
  341.     'F7': _snack.KEY_F7,
  342.     'F8': _snack.KEY_F8,
  343.     'F9': _snack.KEY_F9,
  344.     'F10': _snack.KEY_F10,
  345.     'F11': _snack.KEY_F11,
  346.     'F12': _snack.KEY_F12,
  347.     'ESC': _snack.KEY_ESC,
  348.     ' ': ord(' ') }
  349. for n in hotkeys.keys():
  350.     hotkeys[hotkeys[n]] = n
  351.  
  352.  
  353. class Form:
  354.     ''' Base Form class, from which Grid, etc. inherit
  355.  
  356.     methods:
  357.  
  358.      - Form(self, helpArg = None) : constructor. 
  359.      - addHotKey(self, keyname) : keynames of form "F1" through "F12", "ESC"
  360.      - add(self, widget) : Add a widget
  361.      - run(self): run a  form, expecting input
  362.      - draw(self): draw form.
  363.      - setTimer(self, timer) : add a timer
  364.      - watchFile(self, file, flags) : watch a named file
  365.      - setCurrent (self, co): Set a given widget as the current focus
  366.     '''
  367.     
  368.     def addHotKey(self, keyname):
  369.         self.w.addhotkey(hotkeys[keyname])
  370.  
  371.     
  372.     def add(self, widget):
  373.         if widget.__dict__.has_key('hotkeys'):
  374.             for key in widget.hotkeys.keys():
  375.                 self.addHotKey(key)
  376.             
  377.         
  378.         if widget.__dict__.has_key('gridmembers'):
  379.             for w in widget.gridmembers:
  380.                 self.add(w)
  381.             
  382.         elif widget.__dict__.has_key('w'):
  383.             self.trans[widget.w.key] = widget
  384.             return self.w.add(widget.w)
  385.  
  386.     
  387.     def run(self):
  388.         (what, which) = self.w.run()
  389.         if what == _snack.FORM_EXIT_WIDGET:
  390.             return self.trans[which]
  391.         if what == _snack.FORM_EXIT_TIMER:
  392.             return 'TIMER'
  393.         if what == _snack.FORM_EXIT_FDREADY:
  394.             return self.filemap[which]
  395.         return hotkeys[which]
  396.  
  397.     
  398.     def draw(self):
  399.         self.w.draw()
  400.  
  401.     
  402.     def __init__(self, helpArg = None):
  403.         self.trans = { }
  404.         self.filemap = { }
  405.         self.w = _snack.form(helpArg)
  406.         self.helpArg = helpArg
  407.  
  408.     
  409.     def setCurrent(self, co):
  410.         self.w.setcurrent(co.w)
  411.  
  412.     
  413.     def setTimer(self, timer):
  414.         self.w.settimer(timer)
  415.  
  416.     
  417.     def watchFile(self, file, flags):
  418.         self.filemap[file.fileno()] = file
  419.         self.w.watchfd(file.fileno(), flags)
  420.  
  421.  
  422.  
  423. class Grid:
  424.     """Grid class.
  425.  
  426.     methods:
  427.  
  428.      - place(self,x,y): Return what is placed at (x,y)
  429.      - setField(self, what, col, row, padding = (0, 0, 0, 0),
  430.                 anchorLeft = 0, anchorTop = 0, anchorRight = 0,
  431.                 anchorBottom = 0, growx = 0, growy = 0):
  432.                 used to add widget 'what' to grid.
  433.      - Grid(self, *args): eg. g = Grid(2,3) for 2x3 grid
  434.     """
  435.     
  436.     def place(self, x, y):
  437.         return self.g.place(x, y)
  438.  
  439.     
  440.     def setField(self, what, col, row, padding = (0, 0, 0, 0), anchorLeft = 0, anchorTop = 0, anchorRight = 0, anchorBottom = 0, growx = 0, growy = 0):
  441.         self.gridmembers.append(what)
  442.         anchorFlags = 0
  443.         if anchorLeft:
  444.             anchorFlags = _snack.ANCHOR_LEFT
  445.         elif anchorRight:
  446.             anchorFlags = _snack.ANCHOR_RIGHT
  447.         
  448.         if anchorTop:
  449.             anchorFlags = anchorFlags | _snack.ANCHOR_TOP
  450.         elif anchorBottom:
  451.             anchorFlags = anchorFlags | _snack.ANCHOR_BOTTOM
  452.         
  453.         gridFlags = 0
  454.         if growx:
  455.             gridFlags = _snack.GRID_GROWX
  456.         
  457.         if growy:
  458.             gridFlags = gridFlags | _snack.GRID_GROWY
  459.         
  460.         if what.__dict__.has_key('g'):
  461.             return self.g.setfield(col, row, what.g, padding, anchorFlags, gridFlags)
  462.         return self.g.setfield(col, row, what.w, padding, anchorFlags)
  463.  
  464.     
  465.     def __init__(self, *args):
  466.         self.g = apply(_snack.grid, args)
  467.         self.gridmembers = []
  468.  
  469.  
  470. colorsets = {
  471.     'ROOT': _snack.COLORSET_ROOT,
  472.     'BORDER': _snack.COLORSET_BORDER,
  473.     'WINDOW': _snack.COLORSET_WINDOW,
  474.     'SHADOW': _snack.COLORSET_SHADOW,
  475.     'TITLE': _snack.COLORSET_TITLE,
  476.     'BUTTON': _snack.COLORSET_BUTTON,
  477.     'ACTBUTTON': _snack.COLORSET_ACTBUTTON,
  478.     'CHECKBOX': _snack.COLORSET_CHECKBOX,
  479.     'ACTCHECKBOX': _snack.COLORSET_ACTCHECKBOX,
  480.     'ENTRY': _snack.COLORSET_ENTRY,
  481.     'LABEL': _snack.COLORSET_LABEL,
  482.     'LISTBOX': _snack.COLORSET_LISTBOX,
  483.     'ACTLISTBOX': _snack.COLORSET_ACTLISTBOX,
  484.     'TEXTBOX': _snack.COLORSET_TEXTBOX,
  485.     'ACTTEXTBOX': _snack.COLORSET_ACTTEXTBOX,
  486.     'HELPLINE': _snack.COLORSET_HELPLINE,
  487.     'ROOTTEXT': _snack.COLORSET_ROOTTEXT,
  488.     'EMPTYSCALE': _snack.COLORSET_EMPTYSCALE,
  489.     'FULLSCALE': _snack.COLORSET_FULLSCALE,
  490.     'DISENTRY': _snack.COLORSET_DISENTRY,
  491.     'COMPACTBUTTON': _snack.COLORSET_COMPACTBUTTON,
  492.     'ACTSELLISTBOX': _snack.COLORSET_ACTSELLISTBOX,
  493.     'SELLISTBOX': _snack.COLORSET_SELLISTBOX }
  494.  
  495. class SnackScreen:
  496.     """A Screen;
  497.  
  498.     methods:
  499.  
  500.     - Screen(self) : constructor
  501.     - finish(self)
  502.     - resume(self)
  503.     - suspend(self)
  504.     - doHelpCallback(self,arg) call callback with arg
  505.     - helpCallback(self,cb): Set help callback
  506.     - suspendcallback(self,cb, data=None) : set callback. data=data to pass to cb.
  507.     - openWindow(self,left, top, width, height, title): Open a window.
  508.     - pushHelpLine(self,text): put help line on screen. Returns current help line if text=None
  509.     - setColor(self, colorset, fg, bg): Set foreground and background colors;
  510.             colorset = key from snack.colorsets,
  511.             fg & bg = english color names defined by S-Lang
  512.                 (ref: S-Lang Library C Programmer's Guide section:
  513.                 8.4.4.  Setting Character Attributes)
  514.     """
  515.     
  516.     def __init__(self):
  517.         _snack.init()
  518.         (self.width, self.height) = _snack.size()
  519.         self.pushHelpLine(None)
  520.  
  521.     
  522.     def finish(self):
  523.         return _snack.finish()
  524.  
  525.     
  526.     def resume(self):
  527.         _snack.resume()
  528.  
  529.     
  530.     def suspend(self):
  531.         _snack.suspend()
  532.  
  533.     
  534.     def doHelpCallback(self, arg):
  535.         self.helpCb(self, arg)
  536.  
  537.     
  538.     def helpCallback(self, cb):
  539.         self.helpCb = cb
  540.         return _snack.helpcallback(self.doHelpCallback)
  541.  
  542.     
  543.     def suspendCallback(self, cb, data = None):
  544.         if data:
  545.             return _snack.suspendcallback(cb, data)
  546.         return _snack.suspendcallback(cb)
  547.  
  548.     
  549.     def openWindow(self, left, top, width, height, title):
  550.         return _snack.openwindow(left, top, width, height, title)
  551.  
  552.     
  553.     def pushHelpLine(self, text):
  554.         if not text:
  555.             return _snack.pushhelpline('*default*')
  556.         return _snack.pushhelpline(text)
  557.  
  558.     
  559.     def popHelpLine(self):
  560.         return _snack.pophelpline()
  561.  
  562.     
  563.     def drawRootText(self, left, top, text):
  564.         return _snack.drawroottext(left, top, text)
  565.  
  566.     
  567.     def centeredWindow(self, width, height, title):
  568.         return _snack.centeredwindow(width, height, title)
  569.  
  570.     
  571.     def gridWrappedWindow(self, grid, title, x = None, y = None):
  572.         if x and y:
  573.             return _snack.gridwrappedwindow(grid.g, title, x, y)
  574.         return _snack.gridwrappedwindow(grid.g, title)
  575.  
  576.     
  577.     def popWindow(self, refresh = True):
  578.         if refresh:
  579.             return _snack.popwindow()
  580.         return _snack.popwindownorefresh()
  581.  
  582.     
  583.     def refresh(self):
  584.         return _snack.refresh()
  585.  
  586.     
  587.     def setColor(self, colorset, fg, bg):
  588.         return _snack.setcolor(colorsets[colorset], fg, bg)
  589.  
  590.  
  591.  
  592. def reflow(text, width, flexDown = 5, flexUp = 5):
  593.     ''' returns a tuple of the wrapped text, the actual width, and the actual height
  594.     '''
  595.     return _snack.reflow(text, width, flexDown, flexUp)
  596.  
  597.  
  598. class RadioGroup(Widget):
  599.     ''' Combo widget: Group of Radio buttons
  600.  
  601.     methods:
  602.  
  603.      - RadioGroup(self): constructor.
  604.      - add(self,title, value, default = None): add a button. Returns button.
  605.      - getSelection(self) : returns value of selected button | None    
  606.     '''
  607.     
  608.     def __init__(self):
  609.         self.prev = None
  610.         self.buttonlist = []
  611.  
  612.     
  613.     def add(self, title, value, default = None):
  614.         if not (self.prev) and default == None:
  615.             default = 1
  616.         
  617.         b = SingleRadioButton(title, self.prev, default)
  618.         self.prev = b
  619.         self.buttonlist.append((b, value))
  620.         return b
  621.  
  622.     
  623.     def getSelection(self):
  624.         for b, value in self.buttonlist:
  625.             if b.selected():
  626.                 return value
  627.         
  628.  
  629.  
  630.  
  631. class RadioBar(Grid):
  632.     ''' Bar of Radio buttons, based on Grid.
  633.  
  634.     methods:
  635.  
  636.     - RadioBar(self, screen, buttonlist) : constructor.
  637.     - getSelection(self): return value of selected button 
  638.     '''
  639.     
  640.     def __init__(self, screen, buttonlist):
  641.         self.list = []
  642.         self.item = 0
  643.         self.group = RadioGroup()
  644.         Grid.__init__(self, 1, len(buttonlist))
  645.         for title, value, default in buttonlist:
  646.             b = self.group.add(title, value, default)
  647.             self.list.append((b, value))
  648.             self.setField(b, 0, self.item, anchorLeft = 1)
  649.             self.item = self.item + 1
  650.         
  651.  
  652.     
  653.     def getSelection(self):
  654.         return self.group.getSelection()
  655.  
  656.  
  657.  
  658. class ButtonBar(Grid):
  659.     ''' Bar of buttons, based on grid.
  660.  
  661.     methods:
  662.  
  663.      - ButtonBar(screen, buttonlist,buttonlist, compact = 0):
  664.      - buttonPressed(self, result):  Takes the widget returned by Form.run and looks to see
  665.                      if it was one of the widgets in the ButtonBar.
  666.     '''
  667.     
  668.     def __init__(self, screen, buttonlist, compact = 0):
  669.         self.list = []
  670.         self.hotkeys = { }
  671.         self.item = 0
  672.         Grid.__init__(self, len(buttonlist), 1)
  673.         for blist in buttonlist:
  674.             if type(blist) == types.StringType:
  675.                 title = blist
  676.                 value = string.lower(blist)
  677.             elif len(blist) == 2:
  678.                 (title, value) = blist
  679.             else:
  680.                 (title, value, hotkey) = blist
  681.                 self.hotkeys[hotkey] = value
  682.             if compact:
  683.                 b = CompactButton(title)
  684.             else:
  685.                 b = Button(title)
  686.             self.list.append((b, value))
  687.             self.setField(b, self.item, 0, (1, 0, 1, 0))
  688.             self.item = self.item + 1
  689.         
  690.  
  691.     
  692.     def buttonPressed(self, result):
  693.         if self.hotkeys.has_key(result):
  694.             return self.hotkeys[result]
  695.         for button, value in self.list:
  696.             if result == button:
  697.                 return value
  698.         
  699.  
  700.  
  701.  
  702. class GridFormHelp(Grid):
  703.     ''' Subclass of Grid, for the help form text.
  704.  
  705.     methods:
  706.  
  707.      - GridFormHelp(self, screen, title, help, *args) :
  708.      - add (self, widget, col, row, padding = (0, 0, 0, 0),
  709.             anchorLeft = 0, anchorTop = 0, anchorRight = 0,
  710.             anchorBottom = 0, growx = 0, growy = 0):
  711.      - runOnce(self, x = None, y = None):  pop up the help window
  712.      - addHotKey(self, keyname):
  713.      - setTimer(self, keyname):
  714.      - create(self, x = None, y = None):
  715.      - run(self, x = None, y = None):
  716.      - draw(self):
  717.      - runPopup(self):
  718.      - setCurrent (self, co):
  719.     '''
  720.     
  721.     def __init__(self, screen, title, help, *args):
  722.         self.screen = screen
  723.         self.title = title
  724.         self.form = Form(help)
  725.         self.childList = []
  726.         self.form_created = 0
  727.         args = list(args)
  728.         args[:0] = [
  729.             self]
  730.         apply(Grid.__init__, tuple(args))
  731.  
  732.     
  733.     def add(self, widget, col, row, padding = (0, 0, 0, 0), anchorLeft = 0, anchorTop = 0, anchorRight = 0, anchorBottom = 0, growx = 0, growy = 0):
  734.         self.setField(widget, col, row, padding, anchorLeft, anchorTop, anchorRight, anchorBottom, growx, growy)
  735.         self.childList.append(widget)
  736.  
  737.     
  738.     def runOnce(self, x = None, y = None):
  739.         result = self.run(x, y)
  740.         self.screen.popWindow()
  741.         return result
  742.  
  743.     
  744.     def addHotKey(self, keyname):
  745.         self.form.addHotKey(keyname)
  746.  
  747.     
  748.     def setTimer(self, keyname):
  749.         self.form.setTimer(keyname)
  750.  
  751.     
  752.     def create(self, x = None, y = None):
  753.         if not self.form_created:
  754.             self.place(1, 1)
  755.             for child in self.childList:
  756.                 self.form.add(child)
  757.             
  758.             self.screen.gridWrappedWindow(self, self.title, x, y)
  759.             self.form_created = 1
  760.         
  761.  
  762.     
  763.     def run(self, x = None, y = None):
  764.         self.create(x, y)
  765.         return self.form.run()
  766.  
  767.     
  768.     def draw(self):
  769.         self.create()
  770.         return self.form.draw()
  771.  
  772.     
  773.     def runPopup(self):
  774.         self.create()
  775.         self.screen.gridWrappedWindow(self, self.title)
  776.         result = self.form.run()
  777.         self.screen.popWindow()
  778.         return result
  779.  
  780.     
  781.     def setCurrent(self, co):
  782.         self.form.setCurrent(co)
  783.  
  784.  
  785.  
  786. class GridForm(GridFormHelp):
  787.     ''' GridForm class (extends GridFormHelp):
  788.  
  789.     methods:
  790.  
  791.      - GridForm(self, screen, title, *args):
  792.     '''
  793.     
  794.     def __init__(self, screen, title, *args):
  795.         myargs = (self, screen, title, None) + args
  796.         apply(GridFormHelp.__init__, myargs)
  797.  
  798.  
  799.  
  800. class CheckboxTree(Widget):
  801.     ''' CheckboxTree combo widget,
  802.  
  803.     methods:
  804.  
  805.      - CheckboxTree(self, height, scroll = 0, width = None, hide_checkbox = 0, unselectable = 0)
  806.                     constructor.
  807.      - append(self, text, item = None, selected = 0):
  808.      - addItem(self, text, path, item = None, selected = 0):
  809.      - getCurrent(self):
  810.      - getSelection(self):
  811.      - setEntry(self, item, text):
  812.      - setCurrent(self, item):
  813.      - setEntryValue(self, item, selected = 1):
  814.      - getEntryValue(self, item):
  815.     '''
  816.     
  817.     def append(self, text, item = None, selected = 0):
  818.         self.addItem(text, (snackArgs['append'],), item, selected)
  819.  
  820.     
  821.     def addItem(self, text, path, item = None, selected = 0):
  822.         if item is None:
  823.             item = text
  824.         
  825.         key = self.w.checkboxtreeAddItem(text, path, selected)
  826.         self.key2item[key] = item
  827.         self.item2key[item] = key
  828.  
  829.     
  830.     def getCurrent(self):
  831.         curr = self.w.checkboxtreeGetCurrent()
  832.         return self.key2item[curr]
  833.  
  834.     
  835.     def __init__(self, height, scroll = 0, width = None, hide_checkbox = 0, unselectable = 0):
  836.         self.w = _snack.checkboxtree(height, scroll, hide_checkbox, unselectable)
  837.         self.key2item = { }
  838.         self.item2key = { }
  839.         if width:
  840.             self.w.checkboxtreeSetWidth(width)
  841.         
  842.  
  843.     
  844.     def getSelection(self):
  845.         selection = []
  846.         list = self.w.checkboxtreeGetSelection()
  847.         for key in list:
  848.             selection.append(self.key2item[key])
  849.         
  850.         return selection
  851.  
  852.     
  853.     def setEntry(self, item, text):
  854.         self.w.checkboxtreeSetEntry(self.item2key[item], text)
  855.  
  856.     
  857.     def setCurrent(self, item):
  858.         self.w.checkboxtreeSetCurrent(self.item2key[item])
  859.  
  860.     
  861.     def setEntryValue(self, item, selected = 1):
  862.         self.w.checkboxtreeSetEntryValue(self.item2key[item], selected)
  863.  
  864.     
  865.     def getEntryValue(self, item):
  866.         return self.w.checkboxtreeGetEntryValue(self.item2key[item])
  867.  
  868.  
  869.  
  870. def ListboxChoiceWindow(screen, title, text, items, buttons = ('Ok', 'Cancel'), width = 40, scroll = 0, height = -1, default = None, help = None):
  871.     """
  872.     - ListboxChoiceWindow(screen, title, text, items, 
  873.             buttons = ('Ok', 'Cancel'), 
  874.             width = 40, scroll = 0, height = -1, default = None,
  875.             help = None):
  876.     """
  877.     if height == -1:
  878.         height = len(items)
  879.     
  880.     bb = ButtonBar(screen, buttons)
  881.     t = TextboxReflowed(width, text)
  882.     l = Listbox(height, scroll = scroll, returnExit = 1)
  883.     count = 0
  884.     for item in items:
  885.         if type(item) == types.TupleType:
  886.             (text, key) = item
  887.         else:
  888.             text = item
  889.             key = count
  890.         if default == count:
  891.             default = key
  892.         elif default == item:
  893.             default = key
  894.         
  895.         l.append(text, key)
  896.         count = count + 1
  897.     
  898.     if default != None:
  899.         l.setCurrent(default)
  900.     
  901.     g = GridFormHelp(screen, title, help, 1, 3)
  902.     g.add(t, 0, 0)
  903.     g.add(l, 0, 1, padding = (0, 1, 0, 1))
  904.     g.add(bb, 0, 2, growx = 1)
  905.     rc = g.runOnce()
  906.     return (bb.buttonPressed(rc), l.current())
  907.  
  908.  
  909. def ButtonChoiceWindow(screen, title, text, buttons = [
  910.     'Ok',
  911.     'Cancel'], width = 40, x = None, y = None, help = None):
  912.     """
  913.      - ButtonChoiceWindow(screen, title, text, 
  914.                buttons = [ 'Ok', 'Cancel' ], 
  915.                width = 40, x = None, y = None, help = None):
  916.     """
  917.     bb = ButtonBar(screen, buttons)
  918.     t = TextboxReflowed(width, text, maxHeight = screen.height - 12)
  919.     g = GridFormHelp(screen, title, help, 1, 2)
  920.     g.add(t, 0, 0, padding = (0, 0, 0, 1))
  921.     g.add(bb, 0, 1, growx = 1)
  922.     return bb.buttonPressed(g.runOnce(x, y))
  923.  
  924.  
  925. def EntryWindow(screen, title, text, prompts, allowCancel = 1, width = 40, entryWidth = 20, buttons = [
  926.     'Ok',
  927.     'Cancel'], help = None):
  928.     """
  929.     EntryWindow(screen, title, text, prompts, allowCancel = 1, width = 40,
  930.         entryWidth = 20, buttons = [ 'Ok', 'Cancel' ], help = None):
  931.     """
  932.     bb = ButtonBar(screen, buttons)
  933.     t = TextboxReflowed(width, text)
  934.     count = 0
  935.     for n in prompts:
  936.         count = count + 1
  937.     
  938.     sg = Grid(2, count)
  939.     count = 0
  940.     entryList = []
  941.     for n in prompts:
  942.         if type(n) == types.TupleType:
  943.             (n, e) = n
  944.             if type(e) in types.StringTypes:
  945.                 e = Entry(entryWidth, e)
  946.             
  947.         else:
  948.             e = Entry(entryWidth)
  949.         sg.setField(Label(n), 0, count, padding = (0, 0, 1, 0), anchorLeft = 1)
  950.         sg.setField(e, 1, count, anchorLeft = 1)
  951.         count = count + 1
  952.         entryList.append(e)
  953.     
  954.     g = GridFormHelp(screen, title, help, 1, 3)
  955.     g.add(t, 0, 0, padding = (0, 0, 0, 1))
  956.     g.add(sg, 0, 1, padding = (0, 0, 0, 1))
  957.     g.add(bb, 0, 2, growx = 1)
  958.     result = g.runOnce()
  959.     entryValues = []
  960.     count = 0
  961.     for n in prompts:
  962.         entryValues.append(entryList[count].value())
  963.         count = count + 1
  964.     
  965.     return (bb.buttonPressed(result), tuple(entryValues))
  966.  
  967.  
  968. class CListbox(Grid):
  969.     '''Clistbox convenience class.
  970.  
  971.     methods:
  972.  
  973.      - Clistbox(self, height, cols, cols_widths, scroll = 0)       : constructor
  974.      - colFormText(self, col_text, align = None, adjust_width = 0) : column text.
  975.      - append(self, col_text, item, col_text_align = None)         :
  976.      - insert(self, col_text, item, before, col_text_align = None)
  977.      - delete(self, item)
  978.      - replace(self, col_text, item, col_text_align = None)
  979.      - current(self) : returns current item
  980.      - setCurrent(self, item): sets an item as current
  981.      - clear(self): clear the listbox
  982.      
  983.      Alignments may be LEFT, RIGHT, CENTER, None
  984.     '''
  985.     
  986.     def __init__(self, height, cols, col_widths, scroll = 0, returnExit = 0, width = 0, col_pad = 1, col_text_align = None, col_labels = None, col_label_align = None, adjust_width = 0):
  987.         self.cols = cols
  988.         self.col_widths = col_widths[:]
  989.         self.col_pad = col_pad
  990.         self.col_text_align = col_text_align
  991.         if col_labels != None:
  992.             Grid.__init__(self, 1, 2)
  993.             box_y = 1
  994.             lstr = self.colFormText(col_labels, col_label_align, adjust_width = adjust_width)
  995.             self.label = Label(lstr)
  996.             self.setField(self.label, 0, 0, anchorLeft = 1)
  997.         else:
  998.             Grid.__init__(self, 1, 1)
  999.             box_y = 0
  1000.         self.listbox = Listbox(height, scroll, returnExit, width)
  1001.         self.setField(self.listbox, 0, box_y, anchorRight = 1)
  1002.  
  1003.     
  1004.     def colFormText(self, col_text, align = None, adjust_width = 0):
  1005.         i = 0
  1006.         str = ''
  1007.         c_len = len(col_text)
  1008.         while i < self.cols and i < c_len:
  1009.             cstr = col_text[i]
  1010.             cstrlen = _snack.wstrlen(cstr)
  1011.             if self.col_widths[i] < cstrlen:
  1012.                 if adjust_width:
  1013.                     self.col_widths[i] = cstrlen
  1014.                 else:
  1015.                     cstr = cstr[:self.col_widths[i]]
  1016.             
  1017.             delta = self.col_widths[i] - _snack.wstrlen(cstr)
  1018.             if delta > 0:
  1019.                 if align == None:
  1020.                     a = LEFT
  1021.                 else:
  1022.                     a = align[i]
  1023.                 if a == LEFT:
  1024.                     cstr = cstr + ' ' * delta
  1025.                 
  1026.                 if a == CENTER:
  1027.                     cstr = ' ' * (delta / 2) + cstr + ' ' * ((delta + 1) / 2)
  1028.                 
  1029.                 if a == RIGHT:
  1030.                     cstr = ' ' * delta + cstr
  1031.                 
  1032.             
  1033.             if i != c_len - 1:
  1034.                 pstr = ' ' * self.col_pad
  1035.             else:
  1036.                 pstr = ''
  1037.             str = str + cstr + pstr
  1038.             i = i + 1
  1039.         return str
  1040.  
  1041.     
  1042.     def append(self, col_text, item, col_text_align = None):
  1043.         if col_text_align == None:
  1044.             col_text_align = self.col_text_align
  1045.         
  1046.         text = self.colFormText(col_text, col_text_align)
  1047.         self.listbox.append(text, item)
  1048.  
  1049.     
  1050.     def insert(self, col_text, item, before, col_text_align = None):
  1051.         if col_text_align == None:
  1052.             col_text_align = self.col_text_align
  1053.         
  1054.         text = self.colFormText(col_text, col_text_align)
  1055.         self.listbox.insert(text, item, before)
  1056.  
  1057.     
  1058.     def delete(self, item):
  1059.         self.listbox.delete(item)
  1060.  
  1061.     
  1062.     def replace(self, col_text, item, col_text_align = None):
  1063.         if col_text_align == None:
  1064.             col_text_align = self.col_text_align
  1065.         
  1066.         text = self.colFormText(col_text, col_text_align)
  1067.         self.listbox.replace(text, item)
  1068.  
  1069.     
  1070.     def current(self):
  1071.         return self.listbox.current()
  1072.  
  1073.     
  1074.     def setCurrent(self, item):
  1075.         self.listbox.setCurrent(item)
  1076.  
  1077.     
  1078.     def clear(self):
  1079.         self.listbox.clear()
  1080.  
  1081.  
  1082.